pp108 : Modifying an Existing Document

Modifying an Existing Document

This topic describes the procedure to modify or update an existing document.


You may need to edit a document, modify its properties, or recreate it, depending upon the business requirement. You may also create more documents of the same type from the editor. Process Platform facilitates modifying an existing document from Workspace Documents (Explorer) as well as Workspace Documents (My Recent Documents).

As you modify a model, the changes are being tracked by the system and a ** appears on the titlebar of the document. If you don't want to retain the changes, you have an option to refresh the document and take the document to the last saved state. To do this, click on the toolbar of the editor. Alternatively, if you are in Workspace Documents (Explorer) view, right-click the document that you modified and select (*Refresh). You will see the message - "Refreshing <document name> will discard all changes. Do you want to continue?". Click Yes to revert to the last saved state, and click No to retain the in-progress changes.


Important: In a team setup, it is possible that other developers work on the same documents on which you are working or update or add other documents to the projects. In either case, CWS takes care of updating all the open workspaces containing those documents, as and when a change occurs in the CWS Repository. This activity is handled internally by event service that continuously checks for any modification in the workspace content. The findings are rendered on the UI in the form of confirmation messages that need a user action in response. Tabulated below are the details of the confirmation messages along with the situations in which they appear.

Document in CWS Repository

Document in Workspace Documents

User Action (in response to the prompt)

Modified, Renamed, Deleted, Moved

Opened but not modified


  • Refresh - Receive the updates
  • Cancel - Ignore the updates and close editor. CWS will prompt for refresh the next time it is opened.

Modified, Renamed, Deleted, Moved

Modified by User


  • Discard - Lose all recent changes and revert to the last saved state
  • Save As - Create a new copy with the modifications. Original document will be obsolete.
  • Cancel - Ignore the updates and close editor. CWS will prompt for refresh the next time it is opened.

Modified, Renamed, Deleted, Moved

Not opened

NA. Workspace automatically refreshes the document.

Added

NA

NA. Workspace automatically adds the document to the project.



  • To modify an existing document from Workspace Documents (Explorer), do the following:
  1. In the Workspace Documents (Explorer), open <solution> > <project> and do one of the following:
    • Double-click a document
    • Right-click a document and select Open The document opens in its editor in a separate window.
      Note: If you are working in Classic View, the document opens in the relevant editor to the right side of Workspace Documents. .
  2. Do one of the following:
    • Edit or modify the document and click .
    • On the toolbar of the editor, open the (Quick Access Menu)|Using the Quick Access Menu|This topic provides information on using the Quick Access Menu. to perform several tasks.
    • On the toolbar of the editor, click to create a new document of the same type.
  • To modify an existing document from Workspace Documents (My Recent Documents), do the following:
  1. On Workspace Documents (My Recent Documents), click the document that you want to modify. The document opens in its editor in a separate window.
  2. Do one of the following:
    • Edit or modify the document and click .
    • On the toolbar of the editor, open the (Quick Access Menu)|Using the Quick Access Menu|This topic provides information on using the Quick Access Menu. to perform several tasks.
    • On the toolbar of the editor, click to create a new document of the same typeThe modified document is saved.

      An existing document is modified or updated or a new document is created.

Related tasks

Getting Started with Document Creation
Validating a Document
Publishing a Document to an Organization
Reusing Application Artifacts
Locating an Existing Document in the Workspace

Related information

Working with Workspace Documents